| Note: This tutorial is as same as the MoveIt setup assistant. Just use the OUR robot URDF.. |
 Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags. |
MoveIt setup assistant for OUR robot
Description: MoveIt!'s primary function is generating a Semantic Robot Description Format (SRDF) file for your robot. Additionally, it generates other necessary configuration files for use with the MoveIt! pipeline.Keywords: OUR MoveIt
Tutorial Level: BEGINNER
Contents
Pre-requisites
Already install the ROS and MoveIt!
Follow the instructions for installing MoveIt! first if you have not already done that.
Start
To start the MoveIt! Setup Assistant: roslaunch moveit_setup_assistant setup_assistant.launch This will bringup the start screen with two choices: Create New MoveIt! Configuration Package or Edit Existing MoveIt! Configuration Package.
Click on the Create New MoveIt! Configuration Package button to bring up the following screen:
Click on the browse button and navigate to the UDRF Choose that file and then click Load Files. The Setup Assistant will load the files (this might take a few seconds) and present you with this screen:
Generate Self-Collision Matrix
The Default Self-Collision Matrix Generator searches for pairs of links on the robot that can safely be disabled from collision checking, decreasing motion planning processing time. These pairs of links are disabled when they are always in collision, never in collision, in collision in the robot’s default position or when the links are adjacent to each other on the kinematic chain. The sampling density specifies how many random robot positions to check for self collision. Higher densities require more computation time while lower densities have a higher possibility of disabling pairs that should not be disabled. The default value is 10,000 collision checks. Collision checking is done in parallel to decrease processing time.
Click on the Self-Collisions pane selector on the left-hand side and click on the Regenerate Default Collision Matrixbutton. The Setup Assistant will work for a few second before presenting you the results of its computation in the main table.
Add Virtual Joints
Virtual joints are used primarily to attach the robot to the world. For the PR2 we will define only one virtual joint attaching the base_footprint of the PR2 to the odom_combined world frame. This virtual joint represents the motion of the base of the robot in a plane.
Click on the Virtual Joints pane selector.
Click on Add Virtual Joint Set the joint name as “virtual_joint”
Set the child link as “base” and the parent frame name as “odom_combined”.
Set the Joint Type as “planar”. Click Save and you should see this screen:
Add Planning Groups
Planning groups are used for semantically describing different parts of your robot, such as defining what an arm is, or an end effector.
Click on the Planning Groups pane selector.
Click on Add Group and you should see the following screen:
- We will add the whole arm as a planning group
Add Robot Poses
The Setup Assistant allows you to add certain fixed poses into the configuration. This helps if, for example, you want to define a certain position of the robot as a Home position.
Click on the Robot Poses pane.
Click Add Pose.
Choose a name for the pose.
The robot will be in its Default position where the joint values are set to the mid-range of the allowed joint value range. Move the individual joints around until you are happy and then Save the pose. Note how poses are associated with particular groups. You can save individual poses for each group.
IMPORTANT TIP: Try to move all the joints around. If there is something wrong with the joint limits in your URDF, you should be able to see it immediately here.
Label End Effectors
The OUR_robot does not have any end effectors so we will skip this step.
Add Passive Joints
The OUR_robot does not have any passive joints so we will skip this step.
Generate Configuration Files
You are almost there. One last step - generating all the configuration files that you will need to start using MoveIt!
Click on the Configuration Files pane.
Choose a location and name for the ROS package that will be generated containing your new set of configuration files.
Click on the Generate Package button.
The Setup Assistant will now generate and write a set of launch and config files into the directory of your choosing. All the generated files will appear in the Generated Files/Folders tab and you can click on each of them for a description of what they contain. 
